処理概要

アップロードIDを指定して、マルチパートアップロードでアップロード済のパーツリストを取得する。

リクエスト

リクエストパラメタ

GETで利用できるパラメタは下記になります。

Name	Type	Description	Required
encoding-type	string	レスポンスをエンコードするために要求し、使用するエンコード方式を指定します。	No
uploadId	string	アップロードIDは、リスト済のパートのマルチパートアップロードを区別するものです。	Yes
max-parts	string	レスポンスボディでパーツの最大値を設定します。	No
part-number-marker	string	指定したパーツ番号以降をリスト化します	No

リクエストヘッダー

このオペレーションはすべての操作に共通するリクエストヘッダのみを使用しています。詳細については、一般的なリクエストヘッダを参照してください。

リクエストボディ

なし

リクエストサンプル

GET /sample-bucket/sample-object.txt?uploadId=12345678-9abc-def0-1234-56789abcdef0 HTTP/1.1
Host: 192.168.0.1
Connection: keep-alive
Date: Tue, 01 Sep 2015 10:00:00 +0000
Authorization: AWS EXAMPLEjU2So5By3H5v2:EXAMPLEAjwlAvEi2cPLfQaM588ROWW90so7LwfPr

レスポンス

レスポンスヘッダ

このオペレーションはすべての操作に共通するレスポンスヘッダのみを使用しています。詳細については、一般的なレスポンスヘッダを参照してください。

レスポンスボディ

Name	Type	Description
ListPartsResult	container	レスポンスのコンテナ
Bucket	sring	マルチパートアップロードを開始したbucketの名前
Encoding-Type	string	レスポンスにあるobjectのエンコードタイプ
Key	string	マルチパートアップロードを開始したobjectのキー名
UploadId	string	アップロードID
Initiator	container	マルチパートアップロードを開始したユーザーのコンテナ。内容はOwnerと同様。
ID	string	認証済ユーザーID
DisplayName	string	スクリーン名
Owner	container	スクリーン名とIDのコンテナ
StorageClass	string	アップロード済objectの保管ストレージ種別。”STANDARD”のみ。
PartNumberMarker	integer	パーツリストの開始パーツ番号
NextPartNumberMarker	integer	リストが切断される時、この要素にはリストの最後のパート（リクエストパラメタにある part-number-marker と同じ値）が指定されます。
MaxParts	integer	レスポンスで扱えるパーツの最大数
IsTruncated	boolean	パーツリストが途中で切断されているかを知るフラグ。MaxParts要素に書かれた最大値をパーツ番号が超えていたら、リストは切断されます。
Part	string	特定のパーツに関係するコンテナ。レスポンスには０個以上のPart要素があります。
PartNumber	integer	パーツを識別するパーツ番号
LastModified	datetime	アップロード済パーツの最終更新日時
ETag	string	アップロード済パーツのETag
Size	integer	アップロード済パーツのデータサイズ

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<ListPartsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Bucket>string</Bucket>
    <Encoding-Type>string</Encoding-Type>
    <Key>string</Key>
    <UploadId>string</UploadId>
    <Initiator>
        <ID>string</ID>
        <DisplayName>string</DisplayName>
    </Initiator>
    <Owner>
        <ID>string</ID>
        <DisplayName>string</DisplayName>
    </Owner>
    <StorageClass>string</StorageClass>
    <PartNumberMarker>integer</PartNumberMarker>
    <NextPartNumberMarker>integer</NextPartNumberMarker>
    <MaxParts>integer</MaxParts>
    <IsTruncated>Boolean</IsTruncated>
    <Part>
        <PartNumber>integer</PartNumber>
        <LastModified>Date</LastModified>
        <ETag>string</ETag>
        <Size>integer</Size>
    </Part>
</ListPartsResult>

レスポンスサンプル

HTTP/1.1 200 OK
Date: Tue, 01 Sep 2015 10:00:00 GMT
X-Clv-Request-Id: 01234567-89ab-cdef-0123-456789abcdef
Server: Cleversafe/3.5.1.0
X-Clv-S3-Version: 2.4
x-amz-request-id: 01234567-89ab-cdef-0123-456789abcdef
Content-Length: 698

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ListPartsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Bucket>sample-bucket</Bucket>
    <Key>sample-object.txt</Key>
    <UploadId>12345678-9abc-def0-1234-56789abcdef0</UploadId>
    <Initiator>
        <ID>56789abc-def0-1234-5678-9abcdef01234</ID>
        <DisplayName>abc0001</DisplayName>
    </Initiator>
    <Owner>
        <ID>56789abc-def0-1234-5678-9abcdef01234</ID>
        <DisplayName>abc0001</DisplayName>
    </Owner>
    <StorageClass>STANDARD</StorageClass>
    <MaxParts>1000</MaxParts>
    <IsTruncated>false</IsTruncated>
    <Part>
        <PartNumber>1</PartNumber>
        <LastModified>2015-09-01T10:00:00.000Z</LastModified>
        <ETag>"abcdef0123456789abcdef0123456789"</ETag>
        <Size>12345678</Size>
    </Part>
</ListPartsResult>